home *** CD-ROM | disk | FTP | other *** search
/ PC-SIG: Games / PC-SIG Games (PC-SIG).iso / 1293 / INSTRUCT.DOC < prev    next >
Encoding:
Text File  |  1992-08-12  |  36.9 KB  |  748 lines

  1.                            GAMESCAPE ver B.2
  2.                     Copyright 1988-92 Dennis Drew. 
  3.                      Copyright strictly enforced.
  4.  
  5.               NOW FEATURING INSTANT ON-LINE REGISTRATION!
  6.  
  7. Documentation file.  Please read this.  Use PGUP/PGDN to move through 
  8. the file.  When finished, press ESC to continue with the GSCAPE program.
  9. To print out this file, press P and then use PGDN to move through the 
  10. entire file.  It will be printed as you scroll.
  11.  
  12.                            REGISTRATION FORM
  13.                         (please print clearly)
  14.  
  15. NAME: __________________________________________________________
  16.  
  17. COMPANY NAME: __________________________________________________
  18.  
  19. ADDRESS: _______________________________________________________
  20.  
  21. CITY: ______________________ STATE: _______ ZIP: _______________
  22.  
  23. PHONE: (_____)_______-_______  PURCHASE DATE: _____/_____/______
  24.  
  25. I acquired this program from:___________________________________
  26.  
  27.               On a scale of 1-10, I rate this program a: 
  28.  
  29.                     1  2  3  4  5  6  7  8  9   10
  30.  
  31.  
  32.  
  33. I acknowledge that I have read and agree to the licensing agreement. I 
  34. request to have my name added to your mailing list for future updates 
  35. and information.  
  36.  
  37.  
  38. ___________________________________________ ___________________
  39. signed                                      date
  40.  
  41.             Please send:  ___ 5.25" disks    ___ 3.5" disks
  42.  
  43.        enclose your check for $95 (we pay shipping) and mail to:
  44.               Dennis Drew  PO Box 101   Joplin, MO  64802
  45.                        VISA/MASTERCARD accepted
  46.  
  47. Please pay by international money order or a check drawn on a U.S. 
  48. bank.  Due to difficulty in processing, no foreign checks, please. 
  49.  
  50.                          ALL USERS!!! IMPORTANT!!!
  51.     The following two lines (with the minimum configurations shown) must 
  52. be in your CONFIG.SYS file on your DOS BOOT disk.  
  53.  
  54.                             FILES=20
  55.                             BUFFERS=20
  56.  
  57.     If you do not have a CONFIG.SYS file on your DOS BOOT disk, or if it 
  58. does not contain at least the above specs, then you must update your 
  59. CONFIG.SYS file so that it does.   To do this, switch to your main 
  60. boot drive (usually either A: or C:) and then enter the following 
  61. lines EXACTLY:
  62.  
  63.     COPY CONFIG.SYS + CON CONFIG.SYS (press enter)
  64.     FILES=20 (press enter)
  65.     BUFFERS=20 (press enter)
  66.     (press F6 key)
  67.     (press ENTER)
  68.     (reboot your computer)
  69.  
  70.     If you are unsure about how to do this, contact your computer dealer.  
  71. This computer file is a STANDARD requirement of most modern computer 
  72. programs and should be present on every computer system.   
  73.  
  74.                           WHAT IS GAMESCAPE?
  75.     GAMESCAPE is the fantastic program that allows you to design and 
  76. distribute your own adventure games.  GAMESCAPE is a powerful 
  77. "adventure engine" that allows you to describe locations and rooms, 
  78. objects, recognizable words, messages, and occurrences that happen 
  79. within the game.  You can also include sound, music, and any of the 
  80. standard IBM special graphics characters (terrific for mapping).   
  81. With the advent of version A.3, registered users of gamescape can now 
  82. create high-resolution color graphics to go with their games! 
  83.     Gamescape encodes information so your game secrets cannot be 
  84. easily deciphered by end users, and allows games to be "linked" so 
  85. that your adventures can be of any length.  It provides you the 
  86. ability to design incredibly detailed and LARGE adventure games with 
  87. far greater ease than using a raw programming langauge.   Once the 
  88. game is finished, registered users are allowed to distribute the games 
  89. with NO ROYALTY FEE-- the initial registration is all that's required.  
  90.  
  91.  
  92.      IMPORTANT NOTICE ON NON-REGISTERED GAME DISTRIBUTION LICENSE:
  93.     When we first released GAMESCAPE two years ago, we had one, single 
  94. rule regarding distribution of games produced by GAMESCAPE:  
  95. registered users only!
  96.     Since then we have decided to be a little more lenient.  You may 
  97. distribute your GAMESCAPE adventures without being a registered user, 
  98. under the following license requirements: 
  99.     1. You may not charge for your game in any form, not even a 
  100. diskette duplication fee.  It is illegal to commercially distribute a 
  101. game without express, written permission from the author.  What this 
  102. means in short is that you may give copies to your friends, send them 
  103. to penpals, and enter them in GAMESCAPE contests, but you may not 
  104. market them in any fashion, regardless of profit or non-profit motive, 
  105. without express written permission from the author. 
  106.     2. You may not use advanced GAMESCAPE features.  Advanced features 
  107. are those found in the REGISTERED version, and include:
  108.     LINKing modules     >MSGFL command
  109.     Hires GRAPHICS (although you may use block graphics as is standard
  110.     with the shareware version)
  111.     3. You may not present the game as registered.  You may not use a 
  112. registered version of GAMESCAPE to produce your game (you must use the 
  113. shareware version).
  114.     4. The SCAPERUN.EXE program must be included (of course, or the 
  115. game won't work). 
  116.     Non-compliance with any of these requirements will, by terms of 
  117. our license, void your ownership of your work (in other words, games 
  118. distributed against our license requirements become our property).  
  119. This is not so much for our benefit as it is to protect those who DO 
  120. pay for registration; they deserve the rewards of their payment.
  121.  
  122.                    SPECIAL REGISTERED USER NOTICE!!!
  123.     The REGISTERED version of Gamescape now contains HI-RES GRAPHICS 
  124. ABILITY!!!  Yes, you can create your own B&W or color pictures and add 
  125. them to your games.  This feature is available on the registered 
  126. version only as our way of saying "Thank you for registering!" 
  127.     If you're a registered user, CONGRATULATIONS!  You can just about 
  128. do what you want.  That's what you paid for.  You can use our advanced 
  129. functions including high-res graphics.  You can charge bucks for your 
  130. work.  You can distribute through shareware.  You don't have to pay 
  131. royalties of any kind.  You can give your games away or sell them, and 
  132. pursue any marketing method you wish.  You are fully licensed.  About 
  133. the only thing we require is standard, forseeable stuff, such as:
  134.     1. You must include the SCAPERUN.EXE program when you distribute 
  135. your game (naturally; it's the run-time module).
  136.     2. You may not alter or misrepresent the GAMESCAPE system in any 
  137. manner, or present your games in a manner contrary or harmful to our 
  138. concepts and purposes of GAMESCAPE.  That's all; pretty simple stuff. 
  139.  
  140.     The bottom line:  if you're an unregistered user, feel free to 
  141. give your games to friends and to enter GAMESCAPE contests.  Enjoy 
  142. yourself; we want you to have fun using this excellent program.  But 
  143. remember that there's a lot more available to you if you register! 
  144.  
  145.  
  146.                    INSTRUCTIONS FOR USING GAMESCAPE
  147.     Gamescape is an adventure game development system.  As such it is 
  148. a "programming environment" that provides great power and time-saving 
  149. methods of producing adventure games.
  150.     To see how Gamescape works, enter the following command after 
  151. installation:      GSCAPE SAMPLE
  152.  
  153.     This is the game compiler that will turn the SAMPLE.ADV file into 
  154. an adventure game.  Once the game is compiled, you may then play it by 
  155. exiting Gamescape and entering the command:     SCAPERUN SAMPLE
  156.  
  157.     This will allow you to play the sample adventure game.
  158.  
  159.     Included with this program is GSEDIT.EXE, the powerful Gamescape 
  160. editor.  By examining the TEST.ADV, EASY.ADV and SAMPLE.ADV files you 
  161. may get an idea of how the Gamescape development system works.
  162.  
  163.                        DEVELOPING YOUR OWN GAMES
  164.     The registered version of Gamescape comes with a fully detailed 
  165. instruction manual that lists all of the Gamescape commands and their 
  166. functions.  It also gives you a lot of information about special 
  167. functions of Gamescape not available in the shareware version.
  168.     At this time however, you may begin developing simple adventure 
  169. games by means of the Gamescape Editor, a brand new part of Gamescape 
  170. that helps you in writing correct Gamescape code.  To begin using the 
  171. editor, enter the command:     GSEDIT
  172.  
  173.     We've included a very simple adventure game called EASY that is 
  174. already configured with GSEDIT.  Feel free to examine this file and 
  175. the way it is set up by entering:  GSEDIT EASY
  176.  
  177.  
  178.                           DEVELOPING GRAPHICS
  179.     The graphics development system (GSGRAPH) comes on the updated 
  180. disk we send you when you register.  Once you register, you will be 
  181. able to incorporate high-resolution graphics in your adventure games.  
  182. Gamescape is the most advanced and most powerful game development 
  183. system in the world.  Registration brings you not only a full 
  184. instruction manual and advanced capabilities, it also allows you to 
  185. distribute your developed adventure games without royalty fee.   
  186. Please register today!
  187.  
  188. ======================================================================
  189.  
  190.                             GAMESCAPE  (TM)
  191.  
  192.  
  193.  
  194.             The incredible program that allows you 
  195.             to design and distribute your own 
  196.             adventure games ! 
  197.  
  198.  
  199.                    Now with Hi-Res Color Graphics ! 
  200.  
  201.  
  202. This shortened manual is designed to give you an idea of the 
  203. possibilities of GameScape.  The full manual along with extended 
  204. program commands is included with the registered version. 
  205.  
  206.  
  207.  
  208. Copyright 1991 Dennis Drew.  Copyright strictly enforced. Gamescape TM 
  209. by Dennis Drew.  All rights reserved.  This manual is copyrighted.  
  210. Copying of this manual is expressly forbidden and punishable under 
  211. Federal and Civil law.  Feel free to copy and circulate the SHAREWARE 
  212. version of this program, but NOT THE MANUAL or the REGISTERED DISK ! 
  213.  
  214.                        Produced by Drew Software 
  215.                     PO Box 101   Joplin, MO  64802  
  216.                              (417)781-4248 
  217.  
  218.                                Gamescape
  219.  
  220.     Imagine writing your own adventure games!  Have your family play 
  221. them, give them to your friends, hand them out at computer clubs, or 
  222. even sell them and make a few bucks! 
  223.     Gamescape is the incredible adventure game design system that lets 
  224. you do all this.  Using simple commands which are thoroughly explained 
  225. by an easy-to-understand manual, you can do just about anything you 
  226. would want to do in adventure gaming: 
  227.     * Define rooms, objects, monsters, and actions 
  228.     * Draw maps using IBM character graphics 
  229.     * Play music, sound alarms, beep warnings 
  230.     * NEW !  High resolution color graphics ability !  
  231.  
  232.     Gamescape also allows you to do things that no other adventure 
  233. system allows.  Your games can be of unlimited size and cover multiple 
  234. disks!  Full random features allow you to perform different actions, 
  235. depending on a "throw of the die".  Rather than hundreds of pages of 
  236. instructions and loads of complex commands, Gamescape has a short, 
  237. consise, uncomplicated manual and just a few short but very powerful 
  238. and versatile commands.  There is virtually no limitation to the 
  239. things you can do with Gamescape! 
  240.  
  241.     Purchasing this package and registering as an official user gives 
  242. you the right to distribute your adventure games without paying any 
  243. kind of a royalty fee.  
  244.     So join the world of adventure gaming today.  Gamescape is raw, 
  245. unbridled power, in an easy-to-use package. 
  246.  
  247.                        Produced by Drew Software   
  248.               PO Box 101  Joplin MO  64802  (417)781-4248 
  249.  
  250. Color hires graphics require an EGA/VGA compatible video system.  CGA 
  251. hires graphics will be in monocolor. 
  252.  
  253.  
  254.     Welcome to Gamescape, the program that lets you write your own 
  255. adventure games AND distribute them for fun or profit! 
  256.  
  257.  
  258.                             GAMESCAPE FILES 
  259.     Once the GS system is "unarced", the following files are present: 
  260.  
  261. GSCAPE.EXE        Main GS "compiler", turns your adventure into 
  262.                   machine readable code.    
  263. GSEDIT.EXE        The new GS editor, guides you through editing your
  264.                   games-- helps prevent grammar errors.
  265. GSGRAPH.EXE       High resolution graphics development program.  
  266.                   Requires CGA/EGA/VGA.  (registered version only) 
  267. SCAPERUN.EXE      "Run-time module", must be distributed with your 
  268.                   compiled adventure code in order for the code to 
  269.                   work.  There is no royalty charge for this module. 
  270. MOUSECUR.COM      Nice mouse driver to use with GSGRAPH. (Reg only)
  271. PALETTE.DAT       Standard palette color file (alterable to suit your 
  272.                   taste in colors) 
  273. TABCONVT.EXE      Converts tabs to spaces in your adventure files. 
  274. FIXWS.COM         Converts WordStar and other non-ASCII files to 
  275.                   straight ASCII. 
  276. EASY.ADV          An easy to understand, simple adventure game example. 
  277. EASY.*            Support files to be used with GSEDIT.EXE
  278. TEST.ADV          A sample adventure game that tests most GS functions. 
  279. STARTER.FIL       Startup file that should be used as a basic model for 
  280.                   all of your adventure games. 
  281. SAMPLE.ADV        Small, fully-developed sample adventure game. 
  282. SAMPLE.IN?        "Include" files for SAMPLE.ADV. 
  283. 1.GR0 thru 5.GR6  Graphics files for SAMPLE.ADV 
  284.         
  285.     If these files are not present, please contact us immediately with 
  286. the name and phone/address of the distributor who supplied the game to 
  287. you, and we'll make them rue their existence on earth (as well as 
  288. correct the situation). 
  289.  
  290.                           WHAT IS GAMESCAPE? 
  291.     Gamescape is an adventure engine.  This means that it makes your 
  292. adventure go, by providing the "fuel". 
  293.     An adventure engine allows you to write an adventure game, and 
  294. then execute it by feeding it into a distributable "run-time" program 
  295. that proceeds to make the game work.  This allows the game to be 
  296. distributed.  Gamescape has no memory limitation, for it pulls its 
  297. information from disk.  While the disk access takes a tiny bit longer 
  298. than a totally memory resident system, it does allow you to write 
  299. adventure games limited only by the size of your disk (or in the case 
  300. of Gamescape, which allows linking multiple disks, even larger!).  
  301. Plus, a single engine will run an unlimited number of adventure games 
  302. just by entering SCAPERUN and the adventure name. 
  303.  
  304.                       GAMESCAPE AND YOUR COMPUTER 
  305.     As with any development system, the faster your computer, the 
  306. better.  Gamescape is powerful.  It allows you to develop games of 
  307. almost unlimited size and versatility.  This of course takes 
  308. microprocessor, RAM and disk access time.  While Gamescape works 
  309. properly on a "PC/XT" type machine (8088 microprocessor), it works 
  310. much better on faster computers. 
  311.     8088 systems will work, but will be somewhat slow, especially 
  312. those that are floppy-based.  This is not a fault of Gamescape, but of 
  313. the slow disk and memory access times of those machines.  Of course, 
  314. using Gamescape is still much faster than trying to write an adventure 
  315. game with a standard language compiler.  Then too, there is the 
  316. benefit that your games are no longer limited in size; you can design 
  317. adventure games limited only by the size of your disk.  Gamescape 
  318. really smokes on a 12mhz 286 with a 28ms hard disk drive; that's the 
  319. minimal type of system we recommend for best results from your game 
  320. development environment.  
  321.     But even 8088 disk users will derive value from Gamescape.  Just 
  322. remember that if you have a slow computer, access will be slow.  Be 
  323. patient.  Realize that the first MS-DOS 8088 based computers were 
  324. produced over 10 years ago.  While they're by no means dinosaurs, the 
  325. industry has come a long way since then.  If you plan to write and 
  326. distribute adventure games, you might want to move up to a faster 
  327. machine. 
  328.  
  329.        THE GAMESCAPE INTERFACE -- or how to make the thing work 
  330.  
  331.  
  332.     NORMAL USE.    In order to make Gamescape work,  you must first of 
  333. all have a text editor (or word processor).  The editor must be able 
  334. to output TRUE ASCII text (that is, if you create a file named 
  335. GAME.ADV and then enter TYPE GAME.ADV, you can actually read it).  
  336. PCWrite is one such processor.  So is WordStar if told to save in 
  337. ASCII format.  
  338.     We've included with Gamescape a public-domain program called 
  339. FIXWS.COM which can correct some ill-behaved word processors (such as 
  340. WordStar in normal editing mode).  Note however, that if you use FIXWS 
  341. or other such programs, any graphic characters (explained later) that 
  342. you use in your games will disappear, as these tools remove any non-
  343. standard ASCII characters. 
  344.     In order to use FIXWS, enter the command: FIXWS filename.ADV 
  345.     We do not supply a text editor with Gamescape for two reasons.  
  346.     1- It's reinventing the wheel.  There are plenty of good ones 
  347. already out there that are easily available and cost little or 
  348. nothing. 
  349.     2- Most people already use a word processor and have preferances 
  350. in that area.  No need to change your ways just for this one program.  
  351.     If you don't have a good text editor, you'll probably want to get 
  352. one.  If you want to do it the hard way, the standard DOS program 
  353. EDLIN will serve the purpose.  If you don't know how to use EDLIN, 
  354. then look through those dozens of books you have that explain exactly 
  355. how it works, and learn it.  You only have to learn 6 commands: 
  356.     End/save    Quit     Insert     List       Delete     and    ^Z. 
  357.  
  358.     Realize however that EDLIN is cumbersome, non-powerful, and only 
  359. works with files 64K in length, so it is very limiting.  You can find 
  360. a good public domain editor for little or no money, so I encourage you 
  361. to go that way if you don't already have a text editor.  
  362.     If you decide to use EDLIN, be aware of that 64K limit.  While 
  363. only the very largest of adventure games will exceed that limit, if 
  364. you by chance do so, EDLIN has the nasty habit of erasing the 
  365. remaining text without telling you.  For our purposes, we have found 
  366. that very simple ASCII word processors or programming editors are the 
  367. best.  
  368.     With the advent of DOS 5.0 you can now use the EDIT program that 
  369. comes with DOS.  It does a reasonably good job of editing.
  370.  
  371.     The actual adventure database is created using your editor or the 
  372. new GSEDIT program.  You enter the information using a set of 
  373. guidelines we will present in the registered instruction manual.   
  374. Create your database file using a file extension of .ADV (ie 
  375. GAME.ADV).  You must use the .ADV extension; Gamescape will recognize 
  376. no other. 
  377.     Once you've written the actual adventure, you use the GSCAPE.EXE 
  378. program to compile it.  Compilation turns your adventure into a form 
  379. that Gamescape can read later when the game is actually played. If no 
  380. extension is present, Gamescape automatically adds the .ADV extension. 
  381. So to get the system to compile, you enter the command: GSCAPE 
  382. filename  (you supply the filename) 
  383.     The compiling function creates six new files with the same name as 
  384. your original database, but with the extensions of .GS1 through .GS6.  
  385.     Then you execute the finished game by typing in: SCAPERUN filename 
  386.     Everything is automatic from there on.  Don't expect your 
  387. adventure to work 100% correct the first time; as with any other 
  388. computer project, you'll make mistakes.  But I've put a couple of 
  389. things in the programs to help you locate those errors, so you should 
  390. do OK.  
  391.     Of course, when you distribute your adventure, you have to include 
  392. the SCAPERUN.EXE program with it, because that's what makes the thing 
  393. work.  No problem there; Gamescape was designed with that in mind.  
  394. Just read the licensing agreement and you're all set.  Remember that 
  395. registered users do have extra goodies that they can add to their 
  396. games.  You will find that I'm very friendly with registered users.  
  397. I'll answer questions.  I'll answer letters.  Invite me to a party, 
  398. and I'll probably show up (you pay the travel expenses, o' course!).  
  399.  
  400.                        TRY OUT THE SAMPLE GAME! 
  401.     I've included three sample adventure games called EASY.ADV, 
  402. SAMPLE.ADV, and TEST.ADV.  Try the EASY adventure first.  Then try 
  403. SAMPLE and finally TEST.  SAMPLE contains graphics, and demonstrates 
  404. how graphics appear in the Gamescape environment. 
  405.     This will give you a feel for how Gamescape works, and will show 
  406. you how an adventure data file interfaces with the Gamescape program.  
  407. Go ahead and do this now before reading any further.  SAMPLE is a 
  408. relatively easy adventure game.  It may take you several tries before 
  409. you conquer it, but it only has 5 rooms and will take from 15 minutes 
  410. to an hour to play, depending on your gaming experience.  Once you've 
  411. played it, and read this manual, examine the files thoroughly to see 
  412. how Gamescape works. 
  413.  
  414.                     HOW TO WRITE AN ADVENTURE GAME 
  415.     There are 8 basic steps involved in writing an adventure game.  
  416. These are my concept and you can choose to follow them, alter them for 
  417. your own use, or ignore them as you wish.  But I've found they work 
  418. for me and I feel that if you skip (or skimp on) any one of them, it 
  419. will detract from your game. 
  420.  
  421.     STEP 1.  Start with a theme, a plot that tells what your game is 
  422. going to do.  For example, with my popular game MAROONED AGAIN the 
  423. theme was: 
  424.  
  425.     You have crash-landed on an alien planet.  But all is not lost; 
  426. you have found an alien ship.  The crew apparently died from some 
  427. strange disease.  The ship is still in good condition, but it was not 
  428. built for human anatomy to withstand a blast-off. 
  429.     Fortunately, you have super-strong clones aboard your ship, but 
  430. they were damaged in the crash.  They now only recognize 1 or 2 words 
  431. at a time.  Your goal:  send them aboard the alien ship, find the 
  432. components required to get it to blast off, and send them for help. 
  433.  
  434.     See how that works?  You need a theme of your own, something to 
  435. tie the entire game together. 
  436.  
  437.     STEP 2.  Once the theme is established, start writing down 
  438. individual things you'd like to have happen in the game.  For example, 
  439. you may find a key that's required to open a door located elsewhere.  
  440. Or you may have to fight a robot to gain access to a room.  Don't get 
  441. too complex.  Take my word for it; adventure games get complex all on 
  442. their own as you start writing the actual code.  
  443.  
  444.     STEP 3.  Draw a map.  Set up rooms and corridors, or open land 
  445. areas, etc., keeping in mind the things in step 2 so you can 
  446. incorporate them into your map.  Use a big sheet of paper and make the 
  447. rooms large (2" square is a good size) because you're going to be 
  448. scribbling in details later.  The key to proper adventure game writing 
  449. is advanced planning.  You should have the entire game designed before 
  450. you begin writing one line of code! 
  451.  
  452.     STEP 4.  Number the rooms.  Room #1 is always the starting 
  453. location of the adventure. 
  454.  
  455.     STEP 5.  Go through the rooms one by one and make a list of the 
  456. OBJECTS in the rooms, and the WORDS that will be required to play the 
  457. adventure.  This will only be a partial list; as you test the 
  458. adventure you'll probably find more objects and words that you'll 
  459. need.  Try to be as thorough as possible. 
  460.  
  461.     STEP 6.  Make sure the game is logical.  One of the worst problems 
  462. with many adventure games is that the things the author requires you 
  463. to do don't make any sense.  I remember one game I played where I 
  464. found an Egyptian statue that would kill me every time I got near it.  
  465. I could find no way around this.  When I started asking around and 
  466. tore the game apart, I finally discovered that a ruby found earlier in 
  467. the game (which the game stated was a treasure) was actually the heart 
  468. of the statue, and had to be thrown into a lava pit.  There were no 
  469. clues that this should be done, no hints.  Totally illogical.  I hate 
  470. an adventure game that requires the player to be stupid and do 
  471. ignorant and dumb things in order to make the game work (there is a 
  472. difference of course, between stupid things and sneaky things).  So 
  473. ask yourself as you write the game: If I were playing the game, would 
  474. this be a logical thing to do, something that I might actually think 
  475. of doing?  If the answer is "no", eliminate that thing and do it some 
  476. other way. 
  477.  
  478.  
  479.     STEP 7.  Once you're convinced the game is logical, begin writing 
  480. the code.  There is a file called STARTER.FIL that should be the heart 
  481. of every adventure you write.  It includes standard adventure 
  482. functions, as well as a few required adventure functions that you'll 
  483. need for each game.  You can alter it any way you wish; it's just a 
  484. guideline to use.  
  485.     Of course, do not alter  STARTER.FIL itself; copy it to another 
  486. file:     COPY STARTER.FIL MYGAME.ADV 
  487.     Then use the MYGAME.ADV file to write your adventure. 
  488.  
  489.     STEP 8.  Writing the game and testing it yourself is called the 
  490. alpha stage.  Beta test stage is the important one.  Call in a friend 
  491. who enjoys playing adventure games (not two, because you'll want to 
  492. beta test this on several individuals) and let him have at it.  Grab a 
  493. pencil and notebook and sit by him the whole time.  Don't give any 
  494. hints; figuring out the adventure is part of the testing.  Give hints 
  495. and you'll ruin the spontenaity such testing requires.  Resign 
  496. yourself to the fact that you will most likely need several sessions 
  497. to test a game propery.  This is the research & development stage; R&D 
  498. takes time.  Anything worth doing... 
  499.     As you note errors in the game (and you will) write down the 
  500. circumstances and errors that result.  Take legible, detailed notes.  
  501. But don't alter the game right then unless it is unplayable due to 
  502. that error.  Let your friend finish playing, all the while writing 
  503. down alterations.  Also, make notes of things you wish to add to the 
  504. game; you'll find lots of things to include that you didn't think of 
  505. before.  
  506.     Once your friend has finished playing (this may take many, many 
  507. hours, or even several sessions, depending on the complexity of the 
  508. game) then make the changes to your game, and call over another 
  509. friend.  Go through the same process again.  Do this two, three, four, 
  510. or five times if necessary, until the game is playable.  Don't try to 
  511. cover every possible situation that might occur; just make sure that 
  512. the things you do allow in your game, work properly.  
  513.     After this is done, you are now to gamma production stage, which 
  514. means that your game is ready to distribute. You may still find minor 
  515. bugs in your code as the months go by, but none of them should 
  516. seriously affect game play and for the most part everything will be 
  517. fine.  
  518.  
  519.  
  520.                     VERY IMPORTANT!  DEBUGGING CODE 
  521.     Gamescape is a very complex project, and I would be foolish to 
  522. imagine that some obscure bug doesn't exist somewhere.  If you find a 
  523. legitimate bug, I will appreciate you letting me know.  However, 
  524. please do so under the following guidelines: 
  525.  
  526.     #1 AND MOST IMPORTANT:  Remember that Gamescape is a programming 
  527. environment, and it has been used to generate very complex adventure 
  528. games.  It is therefore reasonable to assume that most (if not all) of 
  529. the bugs have been discovered.  Whenever you find what you think is a 
  530. bug, realize that it is most likely in your game code, and not a 
  531. problem with Gamescape.  
  532.     Before you report a bug, go over your code with a fine tooth comb.  
  533. Whether or not we charge you for examining your code depends on 
  534. whether the bug is caused by Gamescape, or by user coding errors. If 
  535. we have to spend time hunting for a bug that we find to be user 
  536. programming code errors, we will have to bill the user for that time.  
  537. This may seem unfair, but A) we will help the user discover the 
  538. mistake and thus have rendered a programming service and B) we deserve 
  539. to be reimbursed for time/wage/computer expense involved in finding 
  540. user coding errors.  Even in such a case, our rates are reasonable, 
  541. and can be avoided completely if you make sure that a bug report is an 
  542. actual bug.  
  543.     Note that billing will only be done if we feel that significant 
  544. time was wasted.  We're not going to worry about minor work... that's 
  545. just part of doing business and supporting you as a registered user of 
  546. Gamescape.  
  547.     #2:  An error message does not mean a Gamescape bug.  It likely is 
  548. pointing out a problem with your code.  Check out the error; you may 
  549. find it means something like "printer not on" or "disk full" or 
  550. something like that.  Or, it may mean you've left out a part of an 
  551. IF/DO line which causes Gamescape to return an error such as "Out of 
  552. string space" or "Bad record number" or "Illegal function call" (that 
  553. happens more than adventure programmers like to admit). Such things 
  554. are programmer errors, and are not likely to be a fault of Gamescape.  
  555.     #3:  If you do find what you feel to be a legitimate bug, write us 
  556. a letter fully documenting the info.  A phone call is allowed as well, 
  557. but the phone is mainly for answering questions, not in trying to 
  558. trace down a supposed bug.  If you can send us a disk with your source 
  559. code, that will be appreciated as well (source codes will be kept 
  560. extremely private and secured... we will not release or distribute 
  561. them under any circumstance.  They will be used solely for the purpose 
  562. of documenting the bug). 
  563.     #4:  We will not consider any bug report from an unregistered 
  564. user.  No exceptions.  If you claim you have found a bug and we find 
  565. you are not registered, we will totally ignore you. Sorry, but that's 
  566. what registration means: support.  If you are unregistered then you 
  567. are not aware of updates, changes, techniques, etc.  We will not waste 
  568. time with an unregistered user, no matter how legitimate you think 
  569. your problem may be. Bottom line:  registration is cheap; if you want 
  570. the support, then register. 
  571.     #5:  If you do find a legitimate bug, we will send you one of our 
  572. nifty adventures free of charge, as well as give you credit for the 
  573. bug find in future documentation! 
  574.  
  575.     Thanks for your attention to these matters. 
  576.  
  577.  
  578.                          GAMESCAPE ERROR CODES
  579.     Gamescape is written using Microsoft QuickBASIC 3.0 and uses most 
  580. standard BASIC error codes.  I am listing them here for your 
  581. convenience in tracking down your game code errors.  Please note that 
  582. an error that pops up does not likely mean Gamescape has a bug; if you 
  583. have not yet read the section on debugging code, do so now.  It is 
  584. extremely important.  
  585.  
  586. 1   NEXT WITHOUT FOR            
  587. 2   SYNTAX 
  588. 3   RETURN WITHOUT GOSUB    
  589. 4   OUT OF DATA 
  590. 5   ILLEGAL FUNCTION CALL    
  591. 6   OVERFLOW 
  592. 7   OUT OF MEMORY                
  593. 8   UNDEFINED LINE NUMBER 
  594. 9   SUBSCRIPT OUT OF RANGE      
  595. 10  DUPLICATE DEFINITION 
  596. 11  DIVISION BY ZERO                
  597. 12  ILLEGAL DIRECT 
  598. 13  TYPE MISMATCH                
  599. 14  OUT OF STRING SPACE 
  600. 15  STRING TOO LONG                
  601. 16  STRING FORMULA TOO COMPLEX         
  602. 17  CAN'T CONTINUE                
  603. 18  UNDEFINED USER FUNCTION 
  604. 19  NO RESUME                              
  605. 20  RESUME WITHOUT ERROR 
  606. 22  MISSING OPERAND                
  607. 23  LINE BUFFER OVERFLOW 
  608. 24  DEVICE TIMEOUT                
  609. 25  DEVICE FAULT 
  610. 26  FOR WITHOUT NEXT              
  611. 27  OUT OF PAPER  
  612. 29  WHILE WITHOUT WEND        
  613. 30  WEND WITHOUT WHILE 
  614. 50  FIELD OVERFLOW                
  615. 51  INTERNAL ERROR 
  616. 52  BAD FILE NUMBER                
  617. 53  FILE NOT FOUND 
  618. 54  BAD FILE MODE                    
  619. 55  FILE ALREADY OPEN 
  620. 57  DEVICE I/O ERROR                
  621. 58  FILE ALREADY EXISTS 
  622. 61  DISK FULL                        
  623. 62  INPUT PAST END                    
  624. 63  BAD RECORD NUMBER        
  625. 64  BAD FILE NAME                        
  626. 66  DIRECT STATEMENT IN FILE 
  627. 67  TOO MANY FILES 
  628. 68  DEVICE UNAVAILABLE        
  629. 69  COMMUNICATION BUFFER OVERFLOW 
  630. 70  DISK WRITE PROTECT         
  631. 71  DISK NOT READY 
  632. 72  DISK MEDIA ERROR            
  633. 73  ADVANCED FEATURE 
  634. 74  RENAME ACROSS DISKS         
  635. 75  PATH/FILE ACCESS ERROR     
  636. 76  PATH NOT FOUND 
  637.          (you probably didn't install CONFIG.SYS properly) 
  638.  
  639.  
  640.     Please register for Gamescape.  Not only does registration provide 
  641. you with expanded abilities and privileges,  registrations encourage 
  642. us to update the program and add even more power, so that your games 
  643. can be more impressive than ever before.  The more registrations we 
  644. receive, the more eager we are to provide regular updates to the 
  645. program.  Thank you for registering ! 
  646.  
  647.  
  648.     The remainder of this manual is contained in the registered 
  649. version.  To get started writing your own adventure games, please use 
  650. the GSEDIT program.  Realize however, that the registered manual 
  651. provides you with a great deal of information that is required for 
  652. professional game development.  
  653.  
  654.                    THANK YOU FOR EXAMINING GAMESCAPE
  655.  
  656.  
  657.                             end of manual 
  658.  
  659.                 Gamescape is written and published by: 
  660.  
  661.       Drew Software    PO Box 101   Joplin, MO  64802   (417)781-4248 
  662.  
  663. ======================================================================
  664.                       Please read the following: 
  665.     
  666.            IMPORTANT:   HOW TO OBTAIN THE INSTRUCTION MANUAL 
  667.     Our programs are very easy to use.  You do not need an instruction 
  668. manual to operate them.  However, the manual allows you to gain 
  669. greater benefit from this program.  To get the manual, you must 
  670. REGISTER with us.  We depend on your registration fee to continue 
  671. operation.  Registration brings you: 
  672.     1. Instruction manual.
  673.     2. Call-in telephone support.
  674.     3. Places you on our mailing list for notification of future 
  675. updates.  
  676.     4. Usually brings you a more advanced version of the program.
  677.  
  678.     We will support you if you register; absolutely no support will be 
  679. given to non-registered users.  
  680.                                 
  681.                 USER REGISTRATION AND LICENSE AGREEMENT
  682.  
  683. ARTICLE 1. ACCEPTANCE.
  684.     In registering for our programs, the user agrees to abide by all 
  685. articles and restrictions of this license. It is the responsibility of 
  686. the purchaser to note the items of this license, and decide upon 
  687. agreeability of its terms prior to the registration of the program.  
  688.  
  689. ARTICLE 2. LICENSING.  
  690.     This program is licensed, not sold. As such, the user/ 
  691. purchaser has the right to use the program on a day-to-day basis, 
  692. but recognizes the ownership of the program and all materials as 
  693. belonging to Dennis Drew.
  694.  
  695. ARTICLE 3. COPYING AND MULTI-USER.
  696.     This program is USER SUPPORTED.  You are encouraged to copy 
  697. the SHAREWARE diskette and give it to your friends and acquaintences.  
  698. You may use this program freely and distribute it as you wish.  
  699. However, the following restrictions do apply: 
  700.     1. You may not charge a fee for this program, other than for 
  701. the cost of duplication.  
  702.     2. You may not alter the program or supporting items in any 
  703. manner, may not add to or remove items from the disk.  
  704.     3. You may not copy or reproduce in any way the instruction manual 
  705. that is available for this program. The instruction manual is provided 
  706. to REGISTERED USERS ONLY.  Copying of this manual in any form is 
  707. strictly forbidden.  If several copies of the manual are required, 
  708. then a discount is provided on request.  
  709.     4. Shareware companies must obtain a distribution license from the 
  710. author.
  711.  
  712. ARTICLE 4. WARRANTY AND LIABILITY.
  713.      It is the responsibility of the purchaser to decide upon 
  714. usability and application of this program to his/her particular 
  715. needs. Every effort has been made to insure the accuracy and 
  716. reliability of this program. However, since the success of this 
  717. program relies a great deal upon individual use and dedication to 
  718. the use thereof, and the fact that this program is user copiable 
  719. (thus limiting our control over what the end-user receives), 
  720. We will not be held responsible for any results obtained from the 
  721. direct or indirect use of this program nor does this program 
  722. comply to the laws of merchantability of any state.  
  723.  
  724. ARTICLE 5. TERMINATION.
  725.      If the user/purchaser breaks any article of this agreement, 
  726. all items pertaining to the program shall be returned to the 
  727. publisher. This will not exclude any additional punitive damages 
  728. incurred according to national and civil laws.  
  729.  
  730. ARTICLE 6. CUSTOMER SUPPORT.
  731.      We are eager to support our customers. Technical 
  732. assistance is available to REGISTERED USERS ONLY by calling 
  733. (417)781-4248 Monday through Friday during the hours of 9am to 
  734. 5pm.  
  735.      If your diskette is damaged in any way, return it to us along 
  736. with $10.00 to cover cost of replacement. We will rush you a new 
  737. diskette.  
  738.      It is recognized that the purchaser is already bound by the terms 
  739. of the LICENSING AGREEMENT enclosed with this package. This 
  740. registration form serves two purposes: 
  741.      1. To emphasize agreement with the terms of the license.
  742.      2. To allow us to provide you with timely updates and information.  
  743.      
  744.  
  745.                     Thank you for registering!
  746.  
  747.  
  748.